X-Men Legends - XML1-recomp 1.0.1 for Windows

A native Windows version of the original Xbox X-Men Legends, rebuilt from the
game's own code and drawn with a built-in Direct3D 8 renderer.

REQUIREMENTS
- 64-bit Windows 10 or 11.
- A graphics card or integrated GPU with Direct3D support (any modern PC).
- Your own copy of X-Men Legends (World) for the original Xbox, as an ISO.
  Tested ISO SHA-256:
  0a1ef03e57458144609906bbc2d44d2c26028cf704f4698ce0f1e61c34030b44
- About 4 GB of free disk space for the installed game.

INSTALLING
1. Create an empty folder for the game, for example C:\Games\X-Men Legends.
   Use a folder you can write to (not inside Program Files).
2. Extract the entire contents of your X-Men Legends ISO into that folder with
   an Xbox ISO extraction tool (for example extract-xiso or XDVDFS tools).
   default.xbe and folders such as actors, data and textures should now be
   directly inside the folder.
3. Extract everything in XML1-recomp-1.0.1-win64.zip into that same folder.
   Allow it to replace existing files. Keep the hidden .xml1-player-layout file.
4. Double-click X-Men Legends.exe.
   The first launch shows a progress window while it prepares the game files.
   This happens once and can take a few minutes. Later launches start directly.

No Python, separate launcher, runtime DLLs or other downloads are needed.
Keep the whole folder together when moving or copying the game.

UPDATING AN EARLIER VERSION
Close the game, then extract this ZIP over your existing installation and
allow it to replace files. pc-settings.ini and your mods are kept. If you have
changed build.ini, re-apply your changes afterwards.
Saves made with English 0.9.x versions do not load in 1.0 or later, because
the roster is now the original team plus Angel and Bishop; start a new game.
Saves from 1.0, the original Xbox game and French or German 0.9.x versions
still load.

PLAYING
The game starts at 1080p widescreen. It runs in a window or full screen and
has no session timer. Keyboard/mouse and XInput controllers are supported.
Select Quit at the bottom of the main menu, or close the window, to exit.

Options > Advanced Options contains display settings and rebindable controls.
Apply saves pc-settings.ini. Back/Cancel discards unapplied changes.
Display settings, keyboard enable/disable and player assignments take effect
after restarting.
Sound/Music, camera, subtitles and vibration settings are in Options.
Music changes preview while you adjust the slider; Effects changes apply to
new menu sounds. Accept saves these Options settings; Back restores them.

DEFAULT KEYBOARD/MOUSE CONTROLS
WASD: move; Shift: walk; Space: jump; E: use/pick up.
Left mouse or Num 4: attack. Right mouse or Num 6: smash.
Num 5: hold for powers; 1-4: quick powers.
Middle mouse + drag (or V + drag): rotate horizontally, zoom vertically.
I/K: zoom; J/L: rotate. Mouse sensitivity adjusts rotation.
P/O: health/energy pack; C: call allies; arrows: select hero.
M: map; F1: team stats; Esc: pause.
Menus: arrows select, Enter accepts, and Backspace goes back.
Space opens Advanced Options from Options.
Options and Advanced Options support clicking their native controls.

Player 1-4 tabs select the binding profile to edit; Keyboard player selects
which player receives the keyboard and mouse after restarting.
The device panel shows each player's active controller slot and connection.
Select a device row to edit that player's bindings. The binding selector
switches between keyboard/mouse and controller controls.
Defaults 1/2/3 select the selected player's keyboard layout and restore that
player's standard controller bindings. Apply saves the chosen preset; Cancel
discards it. Reset all settings resets all PC profiles and display/input
settings in the draft until you Apply.
Hover a volume label and use the wheel to adjust it.
Movement uses WASD, not XML2's click-to-move/targeting.

SETTINGS FILE (build.ini)
build.ini sits beside the EXE and controls:
- DefaultTextLanguage: eng, fre or ger (menus, subtitles and in-game text).
  Movies and speech are in English.
- PreferFilesLoose: 1 uses the prepared loose files and PKGBs (required for mods).
- modderMode: 1 unlocks all installed characters and costumes; 0 turns it off.
  Unlocks already written to a save stay unlocked.
- graphicsAdapter: auto, or a GPU number if the wrong GPU is chosen.
- HDTextures / HDTexturePack: see HD TEXTURES below.
Restart the game after changing build.ini.

HD TEXTURES
The game can replace its textures with PNG files from a texturepack folder
beside default.xbe. No upscaled pack is included. To make one:
1. Download XML1-recomp-1.0.1-texture-template.zip from the same release.
   It contains every game texture as a PNG at its original size.
2. Upscale the PNGs with the tool of your choice by 2x, 4x or 8x.
   Keep each file name: the 16-character code before .png tells the game
   which texture it replaces. Subfolders do not matter.
3. Put the results in a folder named texturepack beside default.xbe.
Delete a PNG to restore that one texture. Set HDTextures = 0 in build.ini to
play with the original textures. Do not use the template unchanged as a pack:
copies at the original size only re-encode the original textures.

MODS
Game files are loose beside the EXE after the first launch. Original text files
are kept; the game reads their compiled versions (.xmlb, .engb, .chrb, .navb
and similar), so edit those for mods. Existing binary mods are preserved.
The original archive is kept so packaged mode can be restored.

SAVES AND LOGS
UDATA and TDATA contain saved games. The build folder contains diagnostic logs;
include them when reporting a problem.

This is an unofficial project and is not affiliated with the original game's
publishers or developers. X-Men Legends and its artwork belong to their
respective owners. Third-party components retain their licenses; see
runtime\licenses.
